home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / aio_cancel.z / aio_cancel
Text File  |  1998-10-20  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4. AAAAIIIIOOOO____CCCCAAAANNNNCCCCEEEELLLL((((3333))))                                                    AAAAIIIIOOOO____CCCCAAAANNNNCCCCEEEELLLL((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      aio_cancel, aio_cancel64 - cancel an asynchronous I/O request
  10.  
  11. CCCC SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<aaaaiiiioooo....hhhh>>>>
  13.  
  14.      iiiinnnntttt aaaaiiiioooo____ccccaaaannnncccceeeellll((((iiiinnnntttt ffffiiiillllddddeeeessss,,,, aaaaiiiiooooccccbbbb____tttt ****aaaaiiiiooooccccbbbbpppp))));;;;
  15.  
  16.      iiiinnnntttt aaaaiiiioooo____ccccaaaannnncccceeeellll66664444((((iiiinnnntttt ffffiiiillllddddeeeessss,,,, aaaaiiiiooooccccbbbb66664444____tttt ****aaaaiiiiooooccccbbbbpppp))));;;;
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      The _a_i_o__c_a_n_c_e_l() function attempts to cancel one or more asynchronous I/O
  20.      requests currently outstanding against file descriptor _f_i_l_d_e_s. The _a_i_o_c_b
  21.      argument points to the asynchronous I/O control block for a particular
  22.      request to be canceled. If _a_i_o_c_b_p is NULL, then all outstanding
  23.      cancelable asynchronous I/O requests against _f_i_l_d_e_s are canceled.
  24.  
  25.      The _a_i_o__c_a_n_c_e_l_6_4() function is identical to _a_i_o__c_a_n_c_e_l() except that it
  26.      takes an _a_i_o_c_b_6_4__t * (see <aaaaiiiioooo....hhhh>).  This structure allows for the
  27.      specification of a file offset greater than 2 Gigabytes.  The user must
  28.      define ____AAAABBBBIIII____SSSSOOOOUUUURRRRCCCCEEEE and include ----llllaaaabbbbiiii to access the _a_i_o_6_4 routines.
  29.  
  30.      Normal signal delivery shall not occur for asynchronous I/O operations
  31.      that are successfully canceled. If there are requests which can not be
  32.      canceled, then the normal asynchronous completion process shall take
  33.      place for those requests when they are completed.
  34.  
  35.      For requested operations that are successfully canceled the associated
  36.      error status is set to ECANCELED and the return status is -1. For
  37.      requested operations that are not successfully canceled the _a_i_o_c_b_p is not
  38.      modified by _a_i_o__c_a_n_c_e_l().
  39.  
  40.      If _a_i_o_c_b_p is no NULL, then if _f_i_l_d_e_s does not have the same value as the
  41.      file descriptor with which the asynchronous operation was initiated,
  42.      unspecified results occur.
  43.  
  44. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  45.      aio_read(3), aio_write(3), aio_sgi_init(3).
  46.  
  47. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  48.      The _a_i_o__c_a_n_c_e_l() function returns the value AIO_CANCELED to the calling
  49.      process if the requested operation(s) were canceled. The value
  50.      AIO_NOTCANCELED is returned if at least one of the requested operation(s)
  51.      can not be canceled because it is in progress. In this case, the state of
  52.      the other operations, if any, referenced in the call to _a_i_o__c_a_n_c_e_l() is
  53.      not indicated by the return value of _a_i_o__c_a_n_c_e_l(). The application may
  54.      determine the state of affairs for these operations by using _a_i_o__e_r_r_o_r().
  55.      The value AIO_ALLDONE is returned if all of the operations have already
  56.      completed. Otherwise, the function shall return -1, and sets _e_r_r_n_o to
  57.      indicate the error.
  58.  
  59.      If any of the conditions below occur, the _a_i_o__c_a_n_c_e_l() function shall
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. AAAAIIIIOOOO____CCCCAAAANNNNCCCCEEEELLLL((((3333))))                                                    AAAAIIIIOOOO____CCCCAAAANNNNCCCCEEEELLLL((((3333))))
  71.  
  72.  
  73.  
  74.      return -1 and set _e_r_r_n_o to the corresponding value.
  75.  
  76.      [EBADF]        The _f_i_l_d_e_s argument is not a valid file descriptor.
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.